home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 408_01 / snews.doc < prev    next >
Text File  |  1993-08-24  |  37KB  |  815 lines
  1.  
  2.                             Simple NEWS 1.91
  3.                             ================
  4.                              August 25, 1993
  5.  
  6.                              by John McCombs
  7.  
  8.                   Modified by Michael Studte, John Dennis,
  9.                     Kai Uwe Rommel and Daniel Fandrich
  10.  
  11.  
  12. INTRODUCTION
  13. ============
  14.  
  15.     'Simple NEWS' is an news add-on for UUPC.  It is designed to handle
  16.     Usenet news as a leaf node, and offers:
  17.  
  18.       - Threaded news reading.  This allows you to be much more
  19.         selective about what you read, enabling you to cover many more
  20.         newsgroups.
  21.  
  22.       - When a cross-posted article is read, the news-reader
  23.         marks all the other instances of the article as read, too.
  24.  
  25.       - Separate rc files are kept for each user which record the individual
  26.         articles that you have seen.  This is in contrast to some readers
  27.         which simply record the highest article number read.
  28.  
  29.       - Usual range of response facilities: follow-up news, reply by mail,
  30.         forward by mail, save article/thread to disk.
  31.  
  32.       - The extract function (key "w") saves articles to a user-specified
  33.         file in the UUPC mailbox format (with a header of 20 hex 01's).
  34.         Thus, extracted news articles can be read with the mail program
  35.         later, at the user's convenience.
  36.  
  37.       - Built-in support for ISO 8859/1/2/3/4/9 character sets (RFC 1341
  38.         and RFC 1342) and a single key interface to the metamail MIME
  39.         decoder (or other user-specified program).
  40.  
  41.       - Article storage in two files per newsgroup, rather than one file per
  42.         article.  This results in an enormous saving (up to 3:1) in disk
  43.         space on disks with a default cluster size of 4 KB per cluster.
  44.  
  45.       - Processing of batched compressed or uncompressed news.  Control
  46.         messages are not processed.
  47.  
  48.       - Duplicate cross-posted articles are killed during the unbatch stage.
  49.  
  50.       - Post articles are unbatched and uncompressed.  You can only post
  51.         to your 'mailserv' -- you cannot feed another site.  Posting can
  52.         only be done from within the news reader SNews.
  53.  
  54.       - 'Received date' oriented expire to maintain the news database.
  55.  
  56.       - Works with UUPC/extended 1.11n or greater.
  57.  
  58.     I looked at porting Tass and wnews, but in the end decided they were
  59.     far more effort than it was worth, as these news systems were more
  60.     complicated than was necessary for a single user (at a time) DOS
  61.     implementation, especially when the PC is likely to be a leaf node.
  62.  
  63.     Generally, the algorithms used are simple, but the speed is adequate
  64.     for a feed for several users expiring after 5-10 days.  The main
  65.     bottleneck occurs during the 'expire' operation, which must rewrite
  66.     the entire news database.
  67.  
  68.     'Simple NEWS' was built rather quickly (and it shows in places :-) to
  69.     suit my own needs.  I'm distributing it in the hope you might find it
  70.     useful. [jm]
  71.  
  72.     [Posting is a bit of a kludge.  The D... and X... files are created,
  73.     then queued using the UUCP program.  If you look in the source code
  74.     you will see this is all a bit dodgy.  I should sort this out some
  75.     time.  I've tested it by posting to a Waffle system which isn't all
  76.     that fussy, and by posting to a CNEWS/Unix SYSV system, which is
  77.     rather particular].
  78.  
  79.  
  80.   System Requirements
  81.   -------------------
  82.  
  83.     - A minimum of PC-XT with 120k free RAM running under MS-DOS 2.0 or
  84.       newer (has been tested on versions 3.3 and newer).  The unbatch
  85.       program requires much more free RAM if it invokes uncompress on the
  86.       received batches (i.e. not UUPC/extended ver. 1.11x).  If you use a
  87.       lot of TSR's, you could get around this by having your feed use 12 bit
  88.       compression instead of the default 16 bit.
  89.  
  90.     - 200k disk space for the program files plus several megabytes for the
  91.       newsbase, depending on size of the feed.
  92.  
  93.     - You must have installed UUPC/extended and the optional program, UUCP
  94.       in particular.  UUPC/extended version 1.11n and on should work.  You
  95.       do not need any UUPC sources to build Simple NEWS.
  96.  
  97.     The SNews newsreader can be used by multiple users to read news on a
  98.     network if the following conditions are met: TempDir is different for
  99.     each computer, articles are not posted simultaneously to the same
  100.     group by more than one user, and the newsbase manipulation commands
  101.     unbatch.exe, expire.exe and rmgroup.exe are only run when no other
  102.     programs are using the newsbase.
  103.  
  104.     The sources have been compiled with Borland's TC ver. 2.0 and BC++.
  105.     Porting to other MS-DOS ANSI C compilers should be relatively easy.
  106.     [Known non-ANSI functions include Borland's console I/O routines, and
  107.     the intdos() function].
  108.  
  109.     Support for OS/2 has been added to this version of SNews on an
  110.     experimental basis.  Although it appears to be stable, it has not yet
  111.     been as thoroughly tested as the MS-DOS version, so please report any
  112.     problems you have to the author.
  113.  
  114.  
  115.   Introduction to Version 1.91
  116.   ----------------------------
  117.  
  118.     This is an updated version of SNews version 1.90 for MS-DOS.  Two
  119.     derivatives of older versions of SNews are available: for OS/2 (SNews/2
  120.     ver. 2.0), and for running under KA9Q NOS (SNews ver. 1.21).  The OS/2
  121.     version is a "bound" executable and should work under MS-DOS as well.
  122.  
  123.     Please see the section at the end of this file "MAJOR CHANGES TO SNEWS
  124.     1.91" for specific information that differs from previous versions of
  125.     SNews.
  126.  
  127.  
  128.   Support
  129.   -------
  130.  
  131.     I don't want to be *deluged* with complaints, bug reports, or
  132.     suggestions for improvements.  I can think of enough of these for
  133.     myself, :-).  And no whining about the dodgy processing of the headers.
  134.     This will be fixed sometime.
  135.  
  136.     If you have a problem, please try hard to solve it before you contact
  137.     me.  If you find a bug let me know.  Unless a bug absolutely cripples
  138.     you, you'll have to wait for the next release.  This policy arises
  139.     largely out of the fact that email costs me $$$. [jm]
  140.  
  141.     When contacting the author(s) with a problem, contact the last author
  142.     mentioned for whichever version of SNews you are using.  The original
  143.     author cannot be responsible for changes made by a third party (and,
  144.     according to the license, cannot be held responsible for an unchanged
  145.     version, either). [df]
  146.  
  147.  
  148. CAVEATS AND COPYRIGHT
  149. =====================
  150.  
  151.     Version 1.12 of this software is copyright (1991) by John McCombs,
  152.                  Christchurch, New Zealand  <john@ahuriri.gen.nz>
  153.  
  154.     Version 1.90 is copyright 1992 by Michael Studte/John Dennis (Shinohara
  155.                  Industries)
  156.  
  157.     Version 1.91 is copyright 1993 by Daniel Fandrich <dan@fch.wimsey.bc.ca>
  158.                  or <72365.306@compuserve.com> (some portions are copyright
  159.                  1992 by Kai Uwe Rommel <rommel@jonas.bofe.sub.org> or
  160.                  <rommel@informatik.tu-muenchen.de>, and copyright 1985,
  161.                  1989 by Bill Davidsen)
  162.  
  163.     This package is free software, but NOT public domain; you can
  164.     redistribute it and/or modify it under the terms of the GNU
  165.     General Public License, version 1, as published by the Free Software
  166.     Foundation.
  167.  
  168.     This program is distributed in the hope that it will be useful,
  169.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  170.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  171.     GNU General Public License for more details.
  172.  
  173.     See the file COPYING, which contains a copy of the GNU General
  174.     Public License.
  175.  
  176.     The compress program and documentation included with the SNews
  177.     distribution were not written by the SNews authors and are not a formal
  178.     part of SNews.  The are part of the public domain compress ported by
  179.     Donald J. Gloistein.
  180.  
  181.  
  182. ACKNOWLEDGMENTS
  183. ===============
  184.  
  185.     I'd like to thank Steve Kohlenberger, of PreSoft Architects, for
  186.     making suggestions and doing some testing for